package cn.iocoder.yudao.module.reading.service.audio;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.reading.controller.admin.audio.vo.*;
import cn.iocoder.yudao.module.reading.dal.dataobject.audio.AudioResourceDO;

import java.util.List;

/**
 * 音频资源管理 Service 接口
 *
 * @author 芋道源码
 */
public interface AudioResourceService {

    /**
     * 创建音频资源
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createAudioResource(AudioResourceCreateReqVO createReqVO);

    /**
     * 更新音频资源
     *
     * @param updateReqVO 更新信息
     */
    void updateAudioResource(AudioResourceUpdateReqVO updateReqVO);

    /**
     * 删除音频资源
     *
     * @param id 编号
     */
    void deleteAudioResource(Long id);

    /**
     * 获得音频资源
     *
     * @param id 编号
     * @return 音频资源
     */
    AudioResourceDO getAudioResource(Long id);

    /**
     * 获得音频资源分页
     *
     * @param pageReqVO 分页查询
     * @return 音频资源分页
     */
    PageResult<AudioResourceDO> getAudioResourcePage(AudioResourcePageReqVO pageReqVO);

    /**
     * 获得音频资源列表
     *
     * @param listReqVO 列表查询
     * @return 音频资源列表
     */
    List<AudioResourceDO> getAudioResourceList(AudioResourceListReqVO listReqVO);

    /**
     * 批量更新音频资源状态
     *
     * @param ids     音频资源ID列表
     * @param enabled 是否启用
     */
    void batchUpdateAudioResourceStatus(List<Long> ids, Boolean enabled);

    /**
     * 批量删除音频资源
     *
     * @param ids 音频资源ID列表
     */
    void batchDeleteAudioResource(List<Long> ids);

    /**
     * 更新音频资源排序
     *
     * @param id        音频资源ID
     * @param sortOrder 排序权重
     */
    void updateAudioResourceSortOrder(Long id, Integer sortOrder);

    /**
     * 获取音频分类列表
     *
     * @return 分类列表
     */
    List<String> getAudioCategories();

    /**
     * 获取音频语言列表
     *
     * @return 语言列表
     */
    List<String> getAudioLanguages();

    /**
     * 校验音频资源是否存在
     *
     * @param id 编号
     */
    void validateAudioResourceExists(Long id);
}
